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Abstract 

e XML avec PHP 5 (la plupart du code ne marchera pas avec PHP 4.x !!!) 
Une petite introduction sur comment utiliser PHP pour extraire ("parser") et traiter des 
données XML. 

e "simple xml" avec le module SimpleXML functions 

e "stream-parsing" avec le module "XML parser functions" (librairie expat) 

e XSLT et XPath avec le module "XSL functions" (librairie libxslt). 

* Note: PHP avec "DOM" se trouve dans les transparents php-dom ! 


Objectifs 
* Savoir lire des données XML dans un programme PHP 
* Extraire et manipuler des données xml (visualisations, etc.) 


A faire: 
* revoir le tout (il s'agit ici d'une première version pour Php 5) 
* comment éditer (transformer) des données xml 
* un exemple lire du XML avec simple XML pour générer des questionnaires 
e XML Reader functions (PHP 5.1) 
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2. Introduction 


Objectifs du chapitre: 
1. Définitions 
2. Références 


2.1 Que peut-on faire avec PHP ? 


Générer des contenus en XML 
* Générer des contenus en XML est presque aussi facile que générer du HTML 


* Soit vous utilisez des fonctions comme echo, print, sprint, etc. pour directement créer les 
balises, soit vous utilisez une librairie qui vous facilite cette táche. 


Analyse (parsing) 


* "Parsing" c'est la procedure avec laquelle on extrait des données et on les découpe dans des 
morceaux d'information pour les traiter dans la suite. Le programme qui fait le "parsing" 
s'appelle un "parser". 


url: http://www.parsifalsoft.com/gloss.html (Glossaire des termes de parsing) 


Technologies Internet et Education © TECFA 6/3/07 


Introduction à XML avec PHP - 2. Introduction php-xml-5 


2.2 Références et exemples 


Manuels en ligne 
e DOM reference 


url: http://www.w3.org/TR/ 
e Fonctions SimpleXML (dans le site PHP): 


url: http://ch.php.net/manual/en/ref.simplexml.php 
* Fonctions XML "stream-parsing" (sur le site PHP): 


url: http://www.php.net/manual/en/ref.xml.php 


NRPECIOUES avec des exemples: 
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2.3 Les modeles d'analyse 
l| existe deux modèles de "parsing" dans la plupart des langages: 


1. "Stream-parsing" (connu sous le nom de SAX - Simple API for XML - dans le monde 
"Java": 
* se base sur les événements, ca veut dire que le programmeur doit définir 3 fonctions qui notifient 
l'application lorsque le parseur trouve le début, le contenu et la fin d'un élément XML 


2. DOM parsing: fait référence au "Document Object Model" du W3C 
* le parseur traverse un fichier xml et il le ré-construit sous forme d'arbre 
* Le DOM est abordé dans une autre série de transparents: php-dom. 
Le "stream-parsing" est plus rapide et surtout moins gourmand en mémoire, mais plus difficile 
à utiliser dans la plupart des cas. 


3. Dans PHP 5ona "Simple XML" 
e méthode la plus simple à utiliser pour "lire" un fichier XML dans un "array" 
* suffisante pour la plupart des besoins simples 
e Mais attention: ne peut pas toujours remplacer DOM parsing ! 


4. Dans PhP 5.1 on peut avoir "Reader functions" 
* un "pull" parser qui lit noeud par noeud d'un document et qui permet d'extraire des informations. 


Note: Simple XML et DOM acceptent aussi des requétes XPath. 
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3. Générer du XML 


3.1 Le Mimetype et les entétes dans les fichiers 
Lorsque vous produisez d'autres contenus que HTML avec PHP, il faut veiller à deux choses: 


1. Votre serveur doit indiquer à votre client de quel type de document il s'agit (indiquer le 
"Mime Type" 


2. Le document envoyé par votre programme doit contenir les déclarations nécessaires 


A. Définition du mime type 


* Cette instruction qui modifie le message HTTP du serveur doit intervenir tout au début du 
fichier ! (donc éviter toute instruction de type echo, print, etc. avant) 


* Attention, certains formats XML ont leur propre mime-type ! 


Exemple XML 

Header("Content-type: text/xml); 
Exemple SVG 

Header("Content-type: image/svg+xml"); 
Exemple RDF 


Header ("Content-type: application/rdf-rtxml"); 
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B. Les entêtes de vos fichiers 


* || s'agit des lignes 1 (et plus) dans le document transmis. 
XML (simple) 


print (<?xml version-"l.0" eneoding-"riso-9959-1"?2^)57 


Avec SVG: 
printí(^«?xml version-"1.0" encoding-"iso-8859-1"?»' , "\n"); 
print (/<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.0//EN" "http://www.w3.org/TR/ 
2001/PR-SVG-20010719/DTID/svglO0.dtd"»' . "Mn"); 


Exemple 3-1: Générer et afficher un simple contenu avec XML 


<?php 
header("Content-type: text/xml"); 
print (’<?xml version="1.0" encoding="iso-8859-1"?>' . "\n"); 


print (' <?xml-stylesheet href="simple-calcul-xml.css" type="text/css" ?»'); 


Sleisure satisfaction = 5; $work_satisfaction = 7; S$Sfamily satisfaction = 8; 
Sindex = ($leisure satisfaction + $work_satisfaction + $family_satisfaction) 


echo "<resultat> Satisfaction Index = $index </resultat>"; 
?> 


EOE 


Note: pour aller plus loin, voir: 


en.html (Visualisation) 
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4. 


Parsing avec "Simple XML" 


Résumé des fonctionalités 


La fonction "simplexml load file" permet de parser un document XML dans une structure 
PHP qui ressemble à des indexed arrays dans des indexed arrays. On peut donc facilement 
accéder à des éléments (avec des sélecteurs de type "array"). 

On peut aussi effectuer des recherches avec une expression XPath. 

Du manuel: The SimpleXML extension provides a very simple and easily usable toolset to 
convert XML to an object that can be processed with normal property selectors and array 
iterators 

Avantage: On peut trés facilement intégrer une structure XML compléte dans un programme 
PHP et ensuite la manipuler. 

Désavantage: 

* Solution particuliére à PHP, autrement dit ce type d'approche ne se retrouve pas dans d'autres 


langages de programmation (contrairement à DOM et SAX). 
* Le nom de l'élément racine disparait dans la nature (!) 


Note: En PHP 4.x une fonctionalité similaire était disponible sous le nom "xmltree") 
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Principe illustré avec un exemple: 


SimpleXMLElement Object 
[Titre] => Le garçon webmestre <RECIT xmins:xlink="http://www.w3.org/1999/xlink"> 


[Cont xte] => Il était une fois un garçon ni joli ni moche, <Titre>Le garçon webmestre</Titre> 
ni bête ni intelligent, ni drôle ni ennuyeux. <Contexte>Il était une fois un garçon ni joli ni moche, ni 
bête ni intelligent, ni drôle ni ennuyeux. 
[Probleme] => Il était assez heureux dans sa vie de webmaster </Contexte> 
pour l'office de la promotion des technologies anciennes. «Probleme»Il était assez heureux dans sa vie de webmaster 
Toutefois, il lui manquait une amie. pour l'office de la promotion des technologies anciennes. 
Toutefois, il lui manquait une amie. 
[But] => Il fallait que cela change ! «/Probleme» 
| <But>Il fallait que cela change ! 
[FIL] -» SimpleXMLElement Object ( «/But» 
[EPISODE] => Array ( «FIL» 
[0] "CH «EPISODE id="epl "> 
[SousBut] => Un jour il s'est dit qu'il doit agir «SousBut»Un jour il s'est dit qu'il doit agir coüte que 
coûte que coûte. coûte. 
[TENTATIVE] => SimpleXMLElement Object ( «/SousBut» 
[Action] => Il s'est rendu au pub du coin. «TENTATIVE» 
Arrivé au bar il voit un ancien camarade de classe accompagné <Action>Il s'est rendu au pub du coin. Arrivé au bar il 
de deux filles. Ils commencent à discuter et quand il raconta voit un ancien camarade de classe accompagné de deux filles. 
qu'il était WebMaster, une des filles lui demande ce qu'il Ils commencent à discuter et quand il raconta qu'il était 
faisait. Alors il expliqua fièrement qu'il faisait des pages WebMaster, une des filles lui demande ce qu'il faisait. Alors 
HTML avec Frontier. Et avec un élan de courage il demanda à il expliqua fiérement qu'il faisait des pages HTML avec 
la fille s'il pouvait lui offrir un verre. Frontier. Et avec un élan de courage il demanda à la fille 
) S'il pouvait lui offrir un verre.«/Action» 
[Resultat] -» La fille lui répondit: "Non merci". «/ TENTATIVE» 
Un peu désespéré le garçon rentra chez lui. <Resultat>La fille lui répondit: "Non merci". Un peu 


désespéré le garçon rentra chez lui. 
«/Resultat» 


) 
[1] 


Element Object ( 
[SousBut] => Il sentit qu j </EPISODE> 
pas résoudre le problème. <EPISODE id="ep2"> 
[TENTATIVE] => SimpleXMLElement Object ( «SousBut»Il sentit qu'il lui tout seul ne pouvait pas 
[EPISODE] => SimpleXM Element Object ( résoudre le probléme. 
[SousBut] -» Se souvenant qu'il avait une «/SousBut» 
marraine qui occupait un poste important dans les ressources 
humaines, il décida de lui demander conseil. 


Un élément avec enfants devient un simple XML Object 
Ses enfants sont accessibles par une clef (nom de la balise) 
La clef retourne soit un contenu, un XML Object, une liste de XML Objects 
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Exemple 4-1: Lire un fichier XML avec Impress 


url: http://tecfa.unige.ch/guides/php/examples/simplexml-functions/ (répertoire) 


«?php 
if (file exists('story.xml')) { 
$xml = simplexml load file('story.xml'); 


echo "«hr»Here is a dump of the data structure:"; 


echo "<pre>"; 
print_r ($xml); 
echo "</pre>"; 


} else { 
exit('Failed to open story.xml.'); 


} 
?> 

e simplexml load, file() charge un fichier XML 

* print r() imprime une structure de données de facon "human-readable" 

* var dump() imprime plus de détails "techniques". 

* Donc faites un "print r" avant de se lancer dans programmation de l'extration des données 
qui vous intéressent !! 
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Exemple 4-2: Extraire des données avec SimpleXML 


url: hitp: //tecfa.unige.ch/guides/php/examples/simplexml-functions/ "Inm 


$xml = simplexml load file('story.xml'); 


echo "«hr»Here we just display some elements (i.e. &lt;SousBut&gt; and &lt;Resultatégt; 
elements found in RECIT->FIL->EPISODE). &l1t;FIL&gt; can contain several 
&lt;EPISODE&9gt;"; 


Sepisodes = ($xml->FIL->EPISODE); 

foreach ($episodes as $episode) { 
echo "<p>Episode:</p> "; 
echo"<pre>"; 
printf ("Sousbut: %s\n", $episode->SousBut); 
printf("Resultat: %s\n", $episode->Resultat); 
print ===; 
echo"</pre>"; 


e Sxml->FIL->EPISODE collectionne tous les eléments "EPISODE" filles de "FIL". 


e foreach ($episodes as $episode) ... est une technique standarde pour boucler sur tous 
les éléments d'un array. $episode sera lié à chaque item trouvé lors d'un passage. 
* Sepisode->SousBut extrait l'élément SousBut 
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Exemple 4-3: Extraire des données avec pes et Xpath 


url: http: //tecfa.unige.ch/guides/php/examples/simplexml-functions/ "HERMES 


* Meme exemple que le précédant sauf qu'on utilise XPath pour extraire la liste des épisodes. 
$xml = simplexml, load file('story.xml'); 


Sepisodes - $xml-»xpath('//EPISODE'); 


e $xml-»xpath('//EPISODE') collectionne tous les eléments "EPISODE" filles de "FIL". 


e foreach ($episodes as $episode) ... est une technique standarde pour boucler sur tous 
les éléments d'un array. $Sepisode est un item. 
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5. "Stream-parsing" 


Principe du stream parsing: le parseur lit le fichier XML et "crache" des informations: 


e || faut définit des "handlers" qui qui sont appelés par le parser dès qu'il tombe sur un début 
ou une fin d'élément. 


* Le parseur fait appel à ces handlers pour chaque début ou fin de balise: "tiens voilà le début 


d'un élément "p" et "voici la list des attributs". 
* Lorsqu'il tombe sur des caracter data (du contenu), il fait également appel à un handler. 


Identification des "Event Handlers" pour les éléments 

Définition: 

Syntaxe: xml set element handler ($parseur, "start event handler", 
"end event handler") 

Définition formelle du manuel: 

Syntaxe: bool xml set element handler ( resource parser, callback 
Start element handler, callback end element handler ) 

nom handler début" et "nom handler fin" sont fonctions que vous définissez. 


Définition des "Event Handlers 


Les fonctions start-event handler etend event handler (vous pouvez choisir d'autres noms) 
doivent obéir aux définitions suivantes: 


Syntaxe: start element handler ($parser, $nom element, Sattributs) 


Syntaxe: end element handler ($parser, $nom element) 
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Exemple: 
function startElement ($parser, $name, $attrs) 
{ 
print "j'ai trouvé l'’éléement: $name <br>"; 


} 


Identification du character data handler 


Syntaxe: xml_set_character_data_handler ($parser, "characterData"); 


Définition du character data handler 


Syntaxe: characterData($parser, $data) 
Exemple: 


function characterData($xml parser, $data) 
( 

print. data; 
} 
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Exemple 5-1: Structure d'un fichier xml en forme d'une liste des éléments 


url: http://tecfa.unige.ch/guides/php/examples/simple-xml/story.xml 


<? 
$file = "story.xml"; 
Sdepth = 0; 


# appelé au début d'une balise,l'imprime avec une jolie indentation 
function startElement ($parser, $name, $attrs) 


i 
global $depth; 
for ($i = 0; $i < $depth; $i++) 4 
print "&nbsp; &nbsp; &nbsp;"; 
} 
print "$name\n<br>"; 
$Sdepth[$parser]++; 
} 


# appelé à la fin d’une balise et imprime 
function endElement ($parser, $name) 


i 
global $depth; 
Sdepth[S$parser]--; 
for ($i = 0; $i < $depth; $i++) 4 
print "&nbsp; &nbsp; &nbsp;"; 
} 
print "/$name\n<br>"; 
} 
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# créer un "parser" 
$xml parser - xml parser create(); 


# commence à "parser" 
xml set element handler($xml parser, "startElement", "endElement"); 
LE (i (Sfp e toepen(Stfile, "rs"))» À 
die("could not open XML input"); 
) 
while ($data = fread(S$fp, 4096)) { 
if (!xml parse($xml parser, $data, feof($fp))) { 
die(sprintf("XML error: $s at line $d", 
xml. error string(xml. get. error code(s5xml parser)); 
xml get current line number ($xml_parser))); 


# libérer le "parser" 
xml parser free($xml parser); 


?» 
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Exemple 5-2: Visualisation des données xml en html 


<? 


$file = "choco-chip.xml"; 


// Put the key in upper case ! 
$begin array = array ( 


"LIST" => "<HI>RECIPE LIST</H1>", 

"RECIPE" => "<HR>", 

"RECIPE NAME" => "«H2»", 

"AUTHOR" => "Author: <STRONG>", 

"MEAL" => M<H3>", 

"COURSE" => "<I>", 

"INGREDIENTS" => "<H3>Ingrediants</H3><OL>", 
"ITEM" => "<LI>", 

"DIRECTIONS" => "<H3>Directions</H3><BLOCKQUOTE>" 


) ; 


$end array = array( 


"BIST => "<BR>", 
"RECIPE" => "<BR>", 
"RECIPE_NAME" => "</H3>", 
"AUTHOR" => "</STRONG>", 
"MEAL" => "</H2>", 
"COURSE" => "</I>", 


"INGREDIENTS" => "</OL>", 
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"ITEM" => "e loj. 
"DIRECTIONS" => "«/BLOCKQUOTE»" 
); 


function startElement ($parser, $name, $attrs) 
( 
global S$begin array; 
// print "DEBUG: $name <br>"; 
if ($htmlexpr = $begin array[$name]) { 
prant "ohtmlexps"; 


function endElement ($parser, $name) 
i 
global $end array; 
if (Shtmlexpr = $end array[S$name]) { 
print "$htmlexpr"; 


function characterData($parser, $data) 


i 
print $data; 


$xml parser - xml parser create(); 


// use case-folding so we are sure to find the tag in S$begin array 
// does this REALLY work ??? / DKS 
xml parser set option($xml parser, XML OPTION CASE FOLDING, true); 
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xml set element handler($xml parser, "startElement", "endElement"); 
xml set character data handler($xml parser, "characterData"); 


if (!($fp = fopen(Ş$file, "r"))) { 
die ("could not open XML input"); 


while ($data = fread($fp, 4096)) { 
if (!xml parse($xml parser, $data, feof($fp))) { 
die(sprintf("XML error: $s at line $d", 
xml error string(xml get error code($xml parser)), 
xml get current line number($xml parser))); 


xml parser free($xml parser); 


?» 
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6. XSLT avec DOM 


* Attention: Dans le manuel PHP 5 il faut consulter la section XSL (pas XSLT !) 
* Ici on expliquera pas PhP-DOM, copiez simplement de l'exemple ci-dessous 


6.1 Usage simple 


Exemple 6-1: Lire un xml et un XSLT et renvoyer un document 


url: http://tecfa.unige.ch/guides/php/examples/xslt/php-xslt-1.php 
url: http://tecfa.unige.ch/guides/php/examples/xslt/ 


$xml file = 'programme.xml'; 
$xsl file = 'programme.xsl'; 


// load the xml file (and test first if it exists) 
$dom object = new DomDocument (); 
if (!file_exists(ş$xml_file)) exit (Failed to open Sxml file”); 


$dom object-»1oad($xml file); 


// create dom object for the XSL stylesheet and configure the transformer 
$xsl obj - new DomDocument (); 

if (!file_exists(ş$xsl_file)) exit (Failed to open 9xsl File”); 

$xsl obj-»1oad($xsl file); 

$proc - new XSLTProcessor; 

$proc-»importStyleSheet($xsl obj); // attach the xsl rules 


$html fragment = $proc-»transformToXML ($dom object); 
print (Shtml-tfragmenmt); 
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6.2 Inclure des fonctions PHP dans XSLT 
* Attention, les puristes vont vous détester pour cela car le XSLT ne marchera qu'avec PHP 


e Donc utiliser avec modération, c.a.d. seulement quand il manque une fonction importante 
dans XSLT (comme par exemple les fonctions trigonométriques) 


Pour que cela marche il faut enregister les fonctions php dans xslt: 
$Sproc = new XSLTProcessor; 
$9proc-»registerPHPFunctions(); 


Fonctions PHP dans XSLT: 
e || faut déclarer un namespace php 


«xsl:stylesheet version="1.0" 
xmlns:xsl-"http://www.w3.org/1999/XSL/Transform" 
xmlns:phpe"http://php.net/xsl" 
xmlnsixlinke"http:://www.w3.org/1999/xlink"- 


e Syntaxe d'un appel à une fonction PhP: 


oyntdxet phpsrunctrom(' nom de la TODctocon» aro- dog reyp) 


Extrait d'un fichier XSL 


<xsl:variable name-"pos y" select-"$ori y + round(php:function('sin', 
S$atemn angle) * $radius)"/>T 


url: http://tecfa. unige. ch/quides/svg/ex/objects-i in- -circles/ 
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